home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 4 / Atari Forever 4.zip / Atari Forever 4.iso / SERIE_AI / AI_050 / GREPIT / GREPIT.HLP < prev    next >
Text File  |  1998-03-14  |  36KB  |  1,026 lines
  1.  
  2.  
  3.     ≡TABLE OF CONTENTS≡
  4.  
  5.  
  6.  
  7.     ≡INSTALLATION≡
  8.       Disclaimer
  9.       As an accessory
  10.     As a GEM program
  11.  
  12.     ≡ABOUT GREPIT≡
  13.       Overview
  14.     Support
  15.     Credits
  16.  
  17.     ≡GETTING STARTED≡
  18.       As an accessory
  19.     As a GEM program
  20.  
  21.     ≡USE OF DIALOG BOXES≡
  22.  
  23.     ≡USE OF OUTPUT WINDOW≡
  24.  
  25.     ≡THE MAIN DIALOG≡
  26.       Paths
  27.     Files
  28.     Expressions
  29.     Options
  30.     The Popups (The history function)
  31.  
  32.     ≡'EXTENDED OPTIONS' DIALOG≡
  33.  
  34.     ≡'SETTINGS' DIALOG≡
  35.  
  36.     ≡'FONT' DIALOG≡
  37.  
  38.     ≡'COLORS' DIALOG≡
  39.  
  40.     ≡'FIND/MARK' DIALOG≡
  41.  
  42.     ≡'PRINTER SETTINGS' DIALOG≡
  43.  
  44.     ≡'PRINT' DIALOG≡
  45.  
  46.     ≡REGULAR EXPRESSIONS≡
  47.  
  48.     ≡SPECIAL FEATURES≡
  49.       Messages from GREPIT to other programs
  50.     Messages from other programs to GREPIT
  51.  
  52.     ≡EXAMPLES, TIPS AND TRICKS≡
  53.       Converting to and from UNIX
  54.     Extracting of strings or comments
  55.     Search by using expression files (lists)
  56.     GREPIT as a file finder
  57.  
  58.     ≡KEYBOARD SHORTCUTS≡
  59.  
  60.     ≡HELP ON HELP≡
  61.  
  62.     ≡GETTING REGISTERED≡
  63.  
  64.  
  65. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  66.  
  67.  
  68. ≡INSTALLATION≡
  69.  
  70.  
  71. ∙Disclaimer∙
  72.  
  73. MicroService H. Wierl makes no representation or warranty with respect
  74. to the adequacy of this documentation or the programs which it describes
  75. for any particular purpose or with respect to its adequacy to produce
  76. any particular result. In no event shall MicroService H. Wierl be
  77. liable for special, direct, indirect or consequentional damages, losses,
  78. costs, charges, claims, demands, or claim for lost profits, fees or
  79. expenses of any nature or kind.
  80.  
  81.  
  82. You need, at least, the following files to work with GREPIT:
  83.  
  84.     GREPIT.ACC (or GREPIT.PRG or GREPIT.APP)
  85.     GREPIT.RSC
  86.     GREPIT.HLP
  87.     
  88. If there's no GREPIT.HLP there's no help period! Got it? Good ...
  89.  
  90. Just put the three files together in the one (sub-)directory, because
  91. GREPIT loads them from the same directory where it started from. GREPIT
  92. automatically recognizes whether it is an accessory or a normal program.
  93. On Atari TT-models, the TT-Ram-Bits in the program header can (should)
  94. be set for maximum performance (i.e. warp 9.9).
  95.  
  96.  
  97. ∙As an Accessory∙
  98.  
  99. Copy GREPIT.PRG (with GREPIT.RSC and GREPIT.HLP of course) to the root
  100. directory of your boot partition and rename it to GREPIT.ACC.
  101.  
  102.  
  103. ∙As a GEM Program∙
  104.  
  105. You may copy GREPIT to whatever (sub-)directory you like. Use .PRG or
  106. .APP for the extension.
  107.  
  108.  
  109. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  110.  
  111.  
  112. ≡ABOUT GREPIT≡
  113.  
  114.  
  115. ∙Overview∙
  116.  
  117. The program GREPIT is used for pattern matching and string searching in
  118. files. Through the use of regular expressions GREPIT can provide you
  119. with search patterns however complex they may be. These patterns can be
  120. searched for in all types of files.
  121.  
  122. GREPIT also provides you with many options to vary or specify search
  123. and output. GREPIT is a powerful tool mainly for those who deal with
  124. many texts, as in the fields of software development or electronic mail
  125. /communication etc.
  126.  
  127. GREPIT reads files line by line and searches for the pattern. Lines
  128. with possible matches are shown in the output window and written to
  129. the specified output file.
  130.  
  131. GREPIT lets you easily jump into (and back) the found files just by
  132. clicking on a file path or line number in the output window. Virtual
  133. file loading algorithms reduce memory memory consumption and make it
  134. possible to display files larger than available memory.
  135.  
  136. GREPIT is (or will soon be) available for various platforms in addition
  137. to Atari TOS as MS-DOS, MS Windows, Windows 95/NT, OS/2, ...
  138.  
  139. HINT! Don't be surprised if the pattern you are searching for is not
  140. found on the first try. Be especially careful when using regular
  141. expressions, for the outcome may be unexpected!
  142.  
  143. Please thoroughly analyze your search pattern and the outcoming line,
  144. before you verbally abuse GREPIT. Ha Ha ...
  145.  
  146. But! If by chance GREPIT misinterprets a regular expression, please
  147. advise us of this and or any other malfunction (hopefully not ;-)).
  148.  
  149. Many "extras" are featured in this warp speed fast, 110% reliable,  
  150. schwarzenegger powerful and easy to relate to, grep utility. But sorry
  151. dude, you must consult this help function from the beginning to the
  152. bitter end to know what the hell we are talking about! So read on and
  153. we'll make it entertaining. It's worth it, believe us ...
  154.  
  155.  
  156. ∙Support∙
  157.  
  158. Full support is available to registered users only. Please tell us
  159. your serial number when contacting us with questions or problems.
  160. Error reports or suggestions are welcome.
  161.  
  162. Our adress is:
  163.  
  164.         MicroService Hermann Wierl
  165.         Bahnhofstrasse 8
  166.         93336 Altmannstein
  167.         GERMANY
  168.         MO-FR 9-12 a.m. and 2-5 p.m. CET
  169.  
  170.         Phone      :  +49-9446-910002
  171.         Fax        :  +49-9446-910003
  172.         eMail      :  100345.2231@compuserve.com
  173.  
  174. The latest version of GREPIT is periodically uploaded to CompuServe
  175. (ATARIPRO forum, Library #4 "Utility Programs").
  176.  
  177. The archive filename should normally be: GREPTTOS.ZIP
  178.   
  179.  
  180. ∙Credits∙
  181.  
  182. Special Thanx to:
  183.  
  184.   Rita Bergbauer, for the everything-except-computer-support for one
  185.   half of the author team,
  186.   Alison Easton, for English language support and the above mentioned
  187.   for the second half of the author team as well as explaining some
  188.   Beavis and Butthead jokes ;-),
  189.   Hermann Weindl, for permanent puzzling over algorithms,
  190.   Max Heinzlmeir, for his patience in never ending beta tests,
  191.   Gerhard and Martin Huber of Computerislands Bad Gogging for their
  192.   fantastic NOVA graphic cards.
  193.  
  194. Bug reports (especially if you live in Florida - we know how big those
  195. bugs can get) and suggestions for future improvements are welcome and
  196. appreciated! So don't be shy...
  197.  
  198.  
  199. That's all folks. C-ya! Wouldn't wanna B-ya!
  200.  
  201.  
  202. Wolfgang Schamberger                                   Hermann Wierl
  203.  
  204.  
  205. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  206.  
  207.  
  208. ≡GETTING STARTED≡
  209.  
  210.  
  211. ∙As an Accessory∙
  212.  
  213. Choose "Grepit" in the accessory menu. Oooops! Of course... duh!
  214. I kill me!
  215.  
  216.  
  217. ∙As a GEM Program∙
  218.  
  219. Like every other program you start GREPIT by double clicking on the
  220. icon or the program name on your desktop. Did you expect something
  221. else? Sorry, couldn't resist... a duh!
  222.  
  223. Did I forget to mention that you first must switch on your computer?
  224. Ok, let's forget this chapter and continue on...
  225.  
  226.  
  227. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  228.  
  229.  
  230. ≡USE OF DIALOG BOXES≡
  231.  
  232.  
  233. Most aspects of dialog boxes can be used also with keyboard. If there is
  234. an underlined character in a selectable object, just press "Alternate"
  235. along with this character. Exceptions to this rule are the [Cancel]
  236. button, which can be activated by the "Undo" key, and the [?] button
  237. which corresponds with the "Help" key.
  238.  
  239. Since dialog boxes are shown in windows, they are moveable like windows.
  240. Clean 'em from time to time and don't break 'em! (I know, I know, I 
  241. don't do windows!)
  242.  
  243. Edit Fields
  244.  
  245. You can place the cursor into each edit field by clicking the left mouse
  246. button, using the Up/Down arrow keys or the combination Tab/Shift-Tab.
  247.  
  248.  
  249. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  250.  
  251.  
  252. ≡USE OF OUTPUT WINDOW≡
  253.  
  254.  
  255. It is a standard GEM-Window, which also can be used with the keyboard:
  256.  
  257.     Arrow up                        :        scroll up
  258.     Arrow down                    :        scroll down
  259.     Arrow right                    :        scroll right
  260.     Arrow left                    :        scroll left
  261.     Shift and arrow keys:        page scroll
  262.     ClrHome                            :        beginning of the file
  263.     Shift-ClrHome                :        end of the file
  264.     Control-ClrHome            :        adjust window size to maximum and back
  265.     Control-F                        :        find expression in window
  266.     Control-G                        :     repeat find
  267.     Control-P                        :     print file
  268.     Control-U                        :     close window
  269.     Control-C           :   clear output window, free memory
  270.     Alt-T               :   display as text
  271.     Alt-B               :      "    as binary file
  272.     Alt-H               :      "    with hexadecimal values
  273.  
  274.  
  275. Special features:
  276.  
  277. Double click (left mouse button) on a complete file path:
  278.     GREPIT displays this file.
  279. Double click (left mouse button) on a line number:
  280.     GREPIT displays this file beginning with this line.
  281.  
  282. If the double click is neither on a file path nor on a line number,
  283. basically you 're not in Kansas anymore Dorothy! But, GREPIT will
  284. help you out by displaying the "Find" dialog.
  285.  
  286. You return to the previous file either by double clicking the right
  287. mouse button or the "Undo" key. There's no place like home!
  288.  
  289. Brackets surrounding the file path in the window title notify you
  290. of reading a subfile not the main file, use this as a reminder.
  291.  
  292. The above features mentioned can only be used in the main file, not
  293. (yet) in a subfile.
  294.  
  295. If our shell M>DESK is acivated, you can drag a file from any M>DESK
  296. window and drop it onto the GREPIT window and GREPIT will display the
  297. file. Double clicking on a file path in GREPIT with the right mouse
  298. button passes this file to M>DESK. Other protocolls will be implemented
  299. upon demand.
  300.  
  301.  
  302. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  303.  
  304.  
  305. ≡THE MAIN DIALOG≡
  306.  
  307.  
  308. This dialog is the actual center of GREPIT. Here the search process
  309. starts after the input of source paths, files and expressions. History
  310. popups and the most important options are available here. Batteries
  311. not included! The grep process can be interrupted by pressing either
  312. the 'Left Shift + Right Shift' or 'Control + Left Shift + Alternate'
  313. combination.
  314.  
  315.  
  316. ∙Paths∙
  317.  
  318. In this edit field you have to enter the paths (directories) to search
  319. in. You can enter more than one path if you separate them by a semi-
  320. colon. The path specifications hereby follow the standard DOS rules
  321. (i.e. relative and absolute paths etc.). Examples:
  322.  
  323.   C: oder C:\      : Drive C:, starting at the root directory
  324.   
  325.   C:\;D:\;E:\      : Drives C:, D: and E:
  326.   
  327.   \DIR             : The directory DIR on the active drive
  328.   
  329.   C:\DIR\          : The directory DIR on drive C:
  330.  
  331.   C:\DIR;C:\DIR2   : The directories DIR and DIR2 on drive C:
  332.  
  333.  
  334. You can access the file selector by pressing the [Paths:] button
  335. to choose one or more paths. Leave this function by selecting
  336. [Cancel] in the file selector.
  337.  
  338. Hint: If you choose a file instead of a path only, the path and the
  339. file name are automatically split by GREPIT and entered into their
  340. appropriate edit fields.
  341.  
  342.  
  343. ∙Files∙
  344.  
  345. In this edit field you have to enter the file names or specifications
  346. to search in. The usual DOS jokers like '*' and '?' are possible. You
  347. can enter more than one file or specification by separating them with
  348. a semicolon.
  349.  
  350. You can access the file selector by pressing the [Files:] button
  351. to choose one or more files. Leave this function by selecting
  352. [Cancel] in the file selector.
  353.  
  354.            
  355. ∙Expressions∙
  356.  
  357. GREPIT supports regular expressions known from UNIX operating systems.
  358. Regular expressions are specified by giving special meanings to some
  359. characters, like * or ? in command shells. For more details see "REGULAR
  360. EXPRESSIONS".
  361.  
  362. NOTE: There are two ways to make GREPIT search for several expressions
  363. at the same time: (Wow Wee Man)
  364.  
  365. 1. Use the OR symbol "|" to separate expressions in the input line.
  366.  
  367. 2. Write all expressions line by line into a file and use the extension
  368.    .GRE (GRepit Expressions) for it. Simply type the file's name in the
  369.    expression input line and then activate the switch "-f" in the
  370.    "Extended Options" dialog.
  371.    You can find some examples for expression files in the directory
  372.    GRE on the original disk.
  373.    An expression file may contain up to 256 lines with a maximum length
  374.    of 256 characters each.
  375.    
  376. You can access the file selector by pressing the [Expressions:] button
  377. to choose an expression file (the given default extension is set to
  378. .GRE). But don't forget to set the -f flag in the extended options.
  379. Otherwise the filename would be interpreted just as a string.
  380.  
  381. Format of expression files:
  382.  
  383.  --------------------------------------------------------------------
  384.  Expression1
  385.  Expression2
  386.  Expression3|Expression4
  387.  ...
  388.  ...
  389.  ...
  390.  Expression256
  391.  --------------------------------------------------------------------
  392.  
  393.  
  394. ∙Options∙ (I think you understand this term)
  395.  
  396. -b (binary)   : Binary data is skipped. Know what I mean Vern?
  397.  
  398. -d (directory): The subdirectories of the given or current directory
  399.                 are also searched for.
  400.                 
  401. -r (regular)  : Checked : The expression is interpreted as a regular
  402.                 expression.
  403.                 Not checked: The expression stays uninterpreted.
  404.  
  405.                 NOTE: In binary files the expression always stays
  406.                       uninterpreted (no regular expression search).
  407.                       Consider it when entering the expression or
  408.                       activate the option -b (binary skip).
  409.                 
  410.                 The OR character is reserved for separating expressions.
  411.                 If you want to search for this character, you must use
  412.                 a regular expression for it, which is: "\|".
  413.                 Example: You search for "||".
  414.                          Expression = "\|\|"
  415.                 (The chick translating doesn't get it either so
  416.                 forgetaboutit!)
  417.  
  418. -s (sensitive): Capital and small letters are important. So please
  419.                 pay attention!
  420.  
  421. -w (word)     : There is a match only when the searched for expression is
  422.                 found as a word, i.e. when the character before AND after
  423.                 the expression is NOT out of [a-zA-Z0-9_].
  424.  
  425.  
  426.  
  427. Upper/Lower Context
  428.  
  429. Enter the number of lines you want to see above and below the actual
  430. line found.
  431.  
  432. You can access a bunch of additional options by using the [Extended
  433. Options] button in the main dialog or the menu item. For description
  434. see "EXTENDED OPTIONS".
  435.  
  436.  
  437. ∙The Popups∙ (what she likes most, and I'm not talkin' baseball, boys!)
  438.  
  439. For paths, files and expressions there are two history buttons provided
  440. at the right:
  441.  
  442. Automatic history function:
  443.   The left button. Stores the last inputs automatically; up to 15 lines.
  444.  
  445. Manual (permanent) history function:
  446.   The right button. This popup contains input made by the user.
  447.   
  448. To store an entry into the permanent history popup, position the cursor
  449. onto paths, files or expressions edit field and press the "Insert" key.
  450. Then just select a free entry in the popup.
  451.  
  452.  
  453. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  454.  
  455.  
  456. ≡'EXTENDED OPTIONS' DIALOG≡
  457.  
  458.  
  459. -a (append) : The output is appended to the previous file. For the
  460.               meaning of "to append" we recommend Webster's.
  461.  
  462. -c (count)  : Ok 1 2 3 4 5 6 7 8 9 10 ..... Now backwards! Only the total
  463.               number of found lines is shown.
  464.               Example:   C:\DIR\TEST.TXT
  465.                          15 matches.
  466.  
  467. -e (extnd.) : Extended output format. The output file will have a
  468.               short heading and a small statistic at the end (the
  469.               heading at the beginning, of course!!!).
  470.  
  471. -f (file)   : The expressions are taken from a seperate file. Write the
  472.               file name into the expression edit line and set this option
  473.               (for more details see "Examples, Tips and Tricks").
  474.  
  475. -h (hide)   : Hide and seek? Return to count! The filename is hidden.
  476.               Useful for filtering text.
  477.               Attention: Option -h excludes the option -l. Logical,
  478.               ain't it?
  479.  
  480. -l (list)   : If there is a match you will ONLY get the filename.
  481.               Attention: Option -l excludes the option -h.
  482.  
  483. -m (more)   : Length, time and date of the file are added to the filename.
  484.  
  485. -n (number) : The output lines start with the line number (the number in
  486.               the original file of course).
  487.               Example:
  488.                           123:  Output line.
  489.                          
  490.               With a double click on the line number you can jump right
  491.               into the original file to the according position (see "Use
  492.               of Output Window").
  493.  
  494. -p (point)  : The output starts at the beginning of the match.
  495.               Example: Line read = "Have a nice day!"
  496.                        search for "nice"
  497.                        Output    = "nice day!"
  498.  
  499. -u (unix)   : We are not talking of unic's! It just means that all lines
  500.               in the output file end with LF only instead of CR/LF. That's
  501.               useful for transferring files to Unix systems (see Examples,
  502.               Tips and Tricks).
  503.  
  504. -v (verbose): The output is "outputted" on the output device. Well,
  505.               actually I just want to say the output that's on the
  506.               output device is outputted, too. Get it, got it, good!
  507.               I think I need a drink ...
  508.  
  509. -y (onlY)   : The output ends at the end of the match.
  510.               Example: Line read = "Have a nice day!"
  511.                        search for "nice"
  512.                        Output    = "Have a nice"
  513.                       
  514.               The combination of -p and -y gives you the match only.
  515.  
  516. -z (zero)   : All lines which do NOT contain the searched for expression
  517.               are written into the output file.
  518.  
  519.  
  520. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  521.  
  522.  
  523. ≡'SETTINGS' DIALOG≡
  524.  
  525.  
  526. Tabulator size:
  527.   Tab's are expanded to this number of characters.
  528.   
  529. Main dialog at program startup:
  530.   If you set this option the main dialog appears automatically after
  531.   the program starts. Look how much time we try to save you!
  532.   
  533. Confirm on exit:
  534.   You are asked for confirmation before GREPIT terminates.
  535.  
  536. 3D effects:
  537.     The 3D effect can be activated on color resolutions with 16 or more
  538.     colors. If you can't deal with it, just shut it off ;-) !
  539.  
  540. Auto save settings:
  541.   The complete settings (input lines, history popups, window positions
  542.   etc.) are saved automatically every time you quit the program. A
  543.   highly recommended option!
  544.  
  545.  
  546. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  547.  
  548.  
  549. ≡'FONT' DIALOG≡
  550.  
  551.  
  552. You can choose the font and its size for the output and help window. If
  553. GDOS is installed, GDOS fonts (except proportional ones) are displayed
  554. and supported.
  555.  
  556. Hint: Not all GDOS fonts cantain all of the characters. But be opti-
  557. mistic - 10% of the characters aren't missing. You just have 90% to
  558. work with.
  559.  
  560.  
  561. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  562.  
  563.  
  564. ≡'COLORS' DIALOG≡
  565.  
  566.  
  567. I didn't know colors could talk. But in this case you can set the colors
  568. for window background, window text, paths, line numbers and expressions
  569. as well as the headlines in the help function.
  570.  
  571. In reference to colors... Welcome to the 90s. Don't breathe the air.
  572. Don't drink the water. Don't eat fruit, vegetables, meat, fish, sugar,
  573. salt, fats. Don't have sex ever again. No more monochrome resolutions.
  574. Have a nice day!
  575.  
  576. But we stay old fashioned by letting GREPIT work in monochrome. But
  577. invert found expressions.
  578.  
  579.  
  580. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  581.  
  582.  
  583. ≡'FIND/MARK' DIALOG≡
  584.  
  585.  
  586. Come on you know this one (at least the 'Find' part). Just enter the
  587. expression to be found in the output window ... The search always
  588. begins with the first visible line in the window.
  589.  
  590. If the expression is found, the line will be inverted. If no expression
  591. is entered, all find variables are reset, an inverted line disappears.
  592.  
  593. The options are common, too:
  594.  
  595.   [Case sensitive]:
  596.     Capital and small letters matter.
  597.   [Whole Word]:
  598.     There is a match only when the searched for expression is found as
  599.     a word.
  600.   [Regular Expression]:
  601.     The expression is interpreted as a regular expression.
  602.  
  603. The find process can be interrupted by pressing either the
  604. 'Left Shift + Right Shift' or 'Control + Left Shift + Alternate'
  605. combination.
  606.  
  607. You can repeat the search with >Control-G<. In this case search will be
  608. continued with the first visible line in the output window except there
  609. is a found line shown in the window. Then search goes on with the line
  610. after or before this line (depends on the last active search direction).
  611.  
  612. [Mark only] button: The expression entered in this dialog is highlighted
  613. throughout the output window with the color you have set for expressions
  614. in the "Colors" dialog.
  615.  
  616. After every grep process the first expression entered in the main
  617. dialog is marked automatically. This feature allows you to quickly
  618. make any expression in the output window visible without starting a
  619. new grep process.
  620.  
  621. If no expression is entered, no expression will be marked of course.
  622. Tah-Dah!
  623.  
  624.  
  625. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  626.  
  627.  
  628. ≡'PRINTER SETTINGS' DIALOG≡
  629.  
  630.  
  631. You can adjust GREPIT to your printer here. Please enter the values
  632. (escape sequences) in decimal numbers, separated by commas. The
  633. sequences in detail:
  634.  
  635. 'Description':
  636.     No special meaning, just for information.
  637. 'Init Text':
  638.     Sent to the printer before everything else. Normally used for
  639.     printer reset, font and line settings etc.
  640. 'Exit Text':
  641.     Sent at the end of printing. Used for form feed and printer reset.
  642. 'Init Page', 'Exit Page':
  643.     Sequence at every page start and end. The exit page sequence
  644.     (usually a form feed = 12) is sent after the number of lines
  645.     entered in 'Lines per page' edit field in the "Print" dialog.
  646.     If you, for example, don't set a form feed at 'Exit Page', the
  647.     value in 'Lines per page' has no effect.
  648. 'Init Line', 'Exit Line':
  649.     Sequence at every line start and end. For example 5 x the value 32
  650.     as init line makes a left border of 5 spaces. For line exit the
  651.     standard setting is normally '13,10' (13 = Carriage Return, 10 =
  652.     Line Feed).
  653.     
  654. The remaining 2x8 edit fields are for changing critical characters by
  655. replacing characters with printer sequences.
  656.  
  657. With [Load] and [Save] you can write (and read from) the printer setting
  658. to a separate file (default extension is *.DRV).
  659.  
  660.  
  661. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  662.  
  663.  
  664. ≡'PRINT' DIALOG≡
  665.  
  666.  
  667. Print the file presently shown in the output window. You can use the
  668. parallel or serial port. You can also set the number of lines per
  669. page and the number of characters per line.
  670.  
  671. The print process can be interrupted by pressing either the
  672. 'Left Shift + Right Shift' or 'Control + Left Shift + Alternate'
  673. combination.
  674.  
  675. Hint: If you don't set a form feed in the 'Exit Page' sequence of the
  676.       printer setting, the value in 'Lines per page' has no effect, i.e.
  677.       the printer ejects the paper by itself and you will always get the
  678.       maximum number of lines on a page.
  679.  
  680.  
  681. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  682.  
  683.  
  684. ≡REGULAR EXPRESSIONS≡
  685.  
  686.  
  687. Attention and concentration please, here comes the most difficult part
  688. of this manual. This is our implementation of Regular Expressions:
  689.  
  690.   ^      - The circumflex as the first character constrains matches to
  691.            the beginning of lines.
  692.            Ex.: 1) "^blahblah" matches lines beginning with "blahblah".
  693.                 2) "^" matches all non-blank lines.
  694.  
  695.   $      - The dollar sign as the last character constrains matches to
  696.            the end of lines.
  697.            Ex.: 1) "blahblah$" matches lines ending with "blahblah".
  698.                 2) "^blahblah$" matches lines consisting of the single
  699.                    word "blahblah".
  700.  
  701.   .      - The period represents any single character, like the DOS
  702.            wildcard "?".
  703.            Ex.: "Hun.er" matches "Hunter", "Hunger" etc.
  704.  
  705.   [a-z]  - Character group. Represents any character of this group or
  706.            of the given range of characters. Important: A range of
  707.            characters must be given in ASCII order (A-Z, a-z, 0-9 etc.).
  708.            Ex.: 1) "[0-9]" matches all digits from 0 to 9.
  709.                 2) "([0-9]+)" matches "(76)", "(56789)", "(4)" etc.
  710.                    (for the explanation of the "+" specifier read on)
  711.                 3) "^[A-Z]" matches lines starting with capital letters.
  712.  
  713.   [^a-z]  - Negative character group. Represents any character NOT in
  714.             this group or not in the given range of characters.
  715.             Ex.: "Gre[^py]" matches "Green", "Great" etc. but not
  716.                  "Grep", "Grey" etc.
  717.                  
  718.   ?       - The preceeding character or the preceeding character
  719.             group may occur 0 or 1 times. Not to be mistaken for the
  720.             DOS wildcard!
  721.             Ex.: "bla?hblah" matches "blhblah" or "blahblah" but not
  722.                  "blaahblah"
  723.  
  724.   *       - The preceeding character or the preceeding character
  725.             group may occur 0 or more times.
  726.             Ex.: "bla*hblah" matches "blhblah", "blahblah", "blaahblah"
  727.                  "blaaaahblah" and so on...
  728.  
  729.   +       - The preceeding character or the preceeding character
  730.             group may occur 1 or more times.
  731.             Ex.: "bla+hbla" matches "blahblah", "blaaaahblah" etc.
  732.             
  733.   \       - Quote next character. This allows all the above mentioned
  734.             regular expression specifiers to be searched for.
  735.             Ex.: If you want to search for "*" you have to write "\*".
  736.  
  737. ATTENTION: Search for line separator characters (Carriage Returns and/or
  738.            Line Feeds) is not yet supported at this time.
  739.  
  740.  
  741. Input of expressions:
  742.  
  743. You normally just enter the expression(s) in the "Expression(s)" edit
  744. field of the main dialog. But, for very long expressions or many of them
  745. you can use an external expression file. Write all expressions line by
  746. line into a file and use the extension .GRE (GRepit Expressions) for it.
  747. Simply type the file's name in the expression input line of the main
  748. dialog and activate the switch "-f" in the "Extended Options" dialog.
  749. An expression file may contain up to 256 lines with a maximum length
  750. of 256 characters each.
  751.  
  752.  
  753. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  754.  
  755.  
  756. ≡SPECIAL FEATURES≡
  757.  
  758.  
  759. ∙Messages from GREPIT to other programs∙
  760.  
  761. If you double click on a file name or file path with the right mouse
  762. button, GREPIT sends the message GM_SHOW_FILE (8000) to the main
  763. application.
  764.  
  765. For programmers:
  766.   pipe[0]             : contains the message ID 8000 (GM_SHOW_FILE).
  767.   pipe[3] und pipe[4] : contain a pointer to the file name.
  768.   pipe[5] und pipe[6] : contain the number of the line to be displayed,
  769.                         as a long value.
  770.  
  771.  
  772. ∙Messages from other programs to GREPIT∙
  773.  
  774. The above described procedure also works vice versa. If GREPIT receives
  775. the message GM_SHOW_FILE it will display the file.
  776.  
  777.  
  778. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  779.  
  780.  
  781. ≡EXAMPLES, TIPS AND TRICKS≡
  782.  
  783.  
  784. ∙Converting to and from UNIX∙
  785.  
  786. Problem : You have an ASCII file from a UNIX system. UNIX uses only a
  787.           LF (Line Feed) for terminating lines, but TOS normally needs
  788.           the CR/LF (Carriage Return / Line Feed) combination, therefore
  789.           you should convert the file.
  790. Solution: GREPIT can read both types of ASCII files but the output is
  791.           always in TOS format. Just enter the UNIX file path/name in
  792.           the 'Paths'/'Files' fields, use the regular expression ".*"
  793.           which matches all lines and disable all options except the
  794.           "Regular Expression" option in the main dialog. After the
  795.           grep run save the file with the 'Save as...' function.
  796. Example : Expression(s):  .*
  797.              
  798.  or
  799.  
  800. Problem : You want to transfer TOS ASCII files to UNIX systems.
  801. Solution: Do it like the above mentioned and set the flag -u in the
  802.           "Extended Options" dialog. This option lets GREPIT add
  803.           only LF instead of CR/LF to line endings.
  804.           
  805.  
  806. ∙Extracting of C-strings, comments, hex values or functions∙
  807.  
  808. Problem : You want to extract all strings out of a C-project and you
  809.           want to get the strings without the rest of the line.
  810. Solution: Use the regular expression >>>".*"<<< to find all lines
  811.           containing anything in quotation marks. To fade out the
  812.           rest of the line, set the options -p and -y in the "Extended
  813.           Options" dialog.
  814.  
  815.  or
  816.  
  817. Problem : You want to extract comments in a C-project.
  818. Solution: Use the regular expression >>>/\*.*\*/<<<. Remember: "*" is
  819.           a regular expression specifier and you must set a backslash
  820.           in front of it to be interpreted as a normal character!
  821. Suggest.: Begin your C-functions with a header, for example:
  822.           /*****************************************/
  823.           /* Function name: Description            */
  824.           /*****************************************/
  825.           Now you can extract these headers with the above regular
  826.           expression.
  827.  
  828.  or
  829.  
  830. Problem : You want to find all hexadecimal numbers in a C-project.
  831. Solution: Use the regular expression >>>0[xX][0-9a-fA-F]*<<<.
  832.  
  833.  or
  834.  
  835. Problem : You want to find all functions in a C-project.
  836. Solution: Use >>>^[a-zA-Z][a-zA-Z]* *.*([^;]*)[^;]*$<<<. Confused?
  837.  
  838.  
  839. ∙Search by using expression files (lists)∙
  840.  
  841. Problem : You want to extract all calls to GEMDOS functions in your
  842.           C-project.
  843. Solution: Write the names of all GEMDOS functions to a seperate text
  844.           file (for example GEMDOS.GRE) and set the flag -f in the
  845.           extended options dialog. GREPIT will search for all
  846.           expressions listed in this file.
  847.           
  848.           There are some sample files in the folder "GRE" of the
  849.           original GREPIT archive.
  850.  
  851.  
  852. ∙GREPIT as a file finder∙
  853.  
  854. Problem : You need to find a file on your harddisk but you can't
  855.           remember the exact name. The partitions on the harddisk are
  856.           C:, D:, E: and F:. The file name begins with "A" and has the
  857.           extension ".TXT".
  858. Solution: Source(s) : [CDEF]:\A*.TXT
  859.           Expression: .*
  860.           Flags to be set: -d Search subdirectories
  861.                            -l List only file names
  862.           (The regular expression ".*" matches anything.)
  863.           
  864.           To find all ".TXT", ".DOC" and ".TEX" files on drive C: enter:
  865.           Source(s) : C:\*.[TXT|DOC|TEX]
  866.           Expression: .*
  867.           Flags to be set: -d Search subdirectories
  868.                            -l List only file names
  869.  
  870.  
  871.                         ***   !!!   ***
  872. If you have more ideas to utilize GREPIT, let us know! We will collect
  873. and distribute them with GREPIT for the benefit of all GREPIT users.
  874.                         ***   !!!   ***
  875.  
  876.  
  877. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  878.  
  879.  
  880. ≡KEYBOARD SHORTCUTS≡
  881.  
  882.  
  883. ∙Basics∙
  884.  
  885. Basically all elements in a dialog box with a underlined character in
  886. the text can be selected by typing the underlined character combined
  887. with the 'Alternate' key on the keyboard.
  888. The button with the thick black border is the default button and can
  889. be selected by the Return/Enter key.
  890. A [Cancel] button corresponds with the 'Undo' key, a [?] button with
  891. the 'Help' key.
  892.  
  893.  
  894. ∙In the main dialog∙
  895.  
  896. 'Insert' : To store an entry into a permanent history popup.
  897.  
  898.  
  899. ∙To break functions∙
  900.  
  901. 'Left Shift + Right Shift'  or  'Control + Left Shift + Alternate'
  902.  
  903.  
  904. ∙In the output window∙
  905.  
  906. Arrow up                        :        scroll up
  907. Arrow down                    :        scroll down
  908. Arrow right                    :        scroll right
  909. Arrow left                    :        scroll left
  910. Shift and arrow keys:        page scroll
  911. ClrHome                            :        beginning of the file
  912. Shift-ClrHome                :        end of the file
  913. Control-ClrHome            :        adjust window size to maximum and back
  914. Control-F                        :        find expression in window
  915. Control-G                        :     repeat find
  916. Control-P                        :     print file
  917. Control-U                        :     close window
  918. Control-C           :   copy active file to clipboard
  919.  
  920.  
  921. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  922.  
  923.  
  924. ≡HELP ON HELP≡
  925.  
  926.  
  927. The help window can also be used with keyboard shortcuts:
  928.  
  929.     Arrow up                        :        scroll up
  930.     Arrow down                    :        scroll down
  931.     Arrow right                    :        scroll right
  932.     Arrow left                    :        scroll left
  933.     Shift and arrow keys:        page scroll
  934.     ClrHome                            :        beginning of chapter
  935.     Shift-ClrHome                :        end of chapter
  936.     Control-ClrHome            :        adjust window size to maximum and back
  937.     Undo                :   jump to contents
  938.  
  939. ESC, Control-Q, Control-U    or 2 x Undo:     Close help.
  940.  
  941. In the table of contents, a click with the left mouse button on a
  942. chapter headline displays the referring chapter. Return to contents
  943. with a right click anywhere in the help window.
  944.  
  945.  
  946. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  947.  
  948.  
  949. ≡GETTING REGISTERED≡
  950.  
  951.  
  952. The program GREPIT is used for pattern matching and string searching in
  953. files. Through the use of regular expressions GREPIT can provide you
  954. with search patterns however complex they may be. These patterns can be
  955. searched for in all types of files.
  956.  
  957. GREPIT also provides you with many options to vary or specify search
  958. and output. GREPIT is a powerful tool mainly for those who deal with
  959. many texts, as in the fields of software development or electronic mail
  960. /communication etc.
  961.  
  962. GREPIT lets you easily jump into (and back) the found files just by
  963. clicking on a file path or line number in the output window. Virtual
  964. file loading algorithms reduce memory memory consumption and make it
  965. possible to display files larger than available memory.
  966.  
  967. GREPIT is (or will soon be) available for various platforms in addition
  968. to Atari TOS as MS-DOS, MS Windows, Windows NT, OS/2, NeXTstep, Apple,
  969. Unix ...
  970.  
  971. There are NO restrictions in unregistered state. Only the info dialog
  972. will appear at every program startup as an evaluation copy reminder.
  973. There might be a slight delay on program startup especially on slower
  974. machines. This also disappears after registering.
  975.  
  976. GREPIT is distributed as Shareware. It is not free or Public Domain.
  977. This means you may copy and distribute the unregistered version freely
  978. and use it for evaluation purposes without charge for a period of
  979. 30 days. If you use this software beyond the initial evaluation period
  980. the registration fee is required.
  981.  
  982.  
  983.    ----------------------------------------------------------
  984.                ∙REGISTRATION FEE:    US$ 20,--∙
  985.    ----------------------------------------------------------
  986.        or the equivalent amount in your local currency.
  987.  
  988.  
  989. Follow these steps for registration:
  990.  
  991. 1) Send us the form ORDER.TXT (E-Mail, FAX or snail mail) with your
  992.    adress and way of payment
  993.    
  994.    or
  995.    
  996.    You are a CompuServe member. Then just type GO SWREG and register
  997.    online. Enter GREPIT's registration ID #3130 when prompted. The
  998.    registration fee will be charged to your CompuServe account.
  999.  
  1000. 2) After receiving your payment we will send you your serial number
  1001.    and registration code.
  1002.  
  1003. 3) Click on [Register!] in the "...about GREPIT" dialog and enter your
  1004.    name, serial number and registration code.
  1005.    
  1006.    
  1007. And here is our adress:
  1008.  
  1009.         MicroService Hermann Wierl
  1010.         Bahnhofstrasse 8
  1011.         93336 Altmannstein
  1012.         GERMANY
  1013.         MO-FR 9-12 a.m. and 2-5 p.m. CET
  1014.  
  1015.         Phone      :  +49-9446-910002
  1016.         Fax        :  +49-9446-910003
  1017.         eMail      :  100345.2231@compuserve.com
  1018.  
  1019.  
  1020. Please note: After successful registration a file named GREPIT.REG is
  1021. created with your data. Please don't include this file when copying
  1022. because it contains your personal data!
  1023.  
  1024.  
  1025. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1026.